home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / util / moni / Scout.lha / Scout / help / english / scout.doc < prev    next >
Text File  |  1997-09-26  |  68KB  |  2,207 lines
  1.  
  2.                              Scout 37.192
  3.                              Release 2.9
  4.                             User's Manual
  5.           Copyright (C) 1994-97 Andreas Gelhausen, Richard Körber
  6.  
  7. What is Scout?
  8. ==============
  9.  
  10.        Scout is a tool that allows you to monitor your computer
  11. system.  It displays many different things -- like tasks, ports,
  12. assigns, expansion boards, resident commands, interrupts, etc.  -- and
  13. you can perform some certain actions on them.
  14.  
  15.    For example you can freeze tasks, close windows and screens, release
  16. semaphores or remove locks, ports and interrupts.
  17.  
  18. Through AmiTCP it's also possible to use Scout as an TCP/IP service.
  19.  
  20.    Since version 2.0 of Scout you can use nearly all implemented
  21. functions through shell parameters. Therefore it's not necessary to
  22. install MUI for using Scout, but you will need MUI, if you want
  23. to use Scout with its graphical user interface.
  24.  
  25. Copyright
  26. =========
  27.  
  28.    Please read the following parts carefully. You accept the following
  29. terms by starting the software, even for a test drive only.
  30.  
  31. COPYRIGHT
  32.      Scout 37.192 (Release 2.9) - Copyright (C) 1994-97 by Andreas
  33.      Gelhausen and Richard Körber, all rights reserved.
  34.  
  35.      You only have the right to use the software, but no rights on the
  36.      software itself. Disassembling, resourcing and all other ways of
  37.      reverse engineering is forbidden.
  38.  
  39. FREEWARE
  40.      Scout is FreeWare. You are allowed to use the packet without
  41.      paying a fee or similar to the authors. Of course we would
  42.      appreciate a small donor! ;-)
  43.  
  44. COPYING
  45.      You can copy the packet as long as it remains entire and unchanged.
  46.  
  47.      You are allowed to compress the packet using a customary
  48.      compression software (as lha, lzh, lzx, dms). You must not
  49.      compress single files of the packet (e.g. PowerPacker or Imploder).
  50.  
  51. DISTRIBUTION
  52.      You must not exceed an usual price on the market for your working
  53.      and material. This means a maximum of 5 DM (or the equivalent
  54.      amount in other currencies, including all taxes) for disks and 35
  55.      DM for CD-ROMs containing a PD software collection.
  56.  
  57.      In any case, you need a written permission from us if you want to
  58.      include Scout on a cover disk or in connection with a commercial
  59.      product.
  60.  
  61.      We explicitly permit the distribution via AmiNet, Meeting Pearls
  62.      and Fred Fish.
  63.  
  64. LIABILITY
  65.      You are using the program as it is, with all flaws, and on your
  66.      own risk! We grant no warranty for the software meeting a special
  67.      purpose. This software may cause financial damage or harm people.
  68.  
  69. LIMITATIONS
  70.      You are not allowed to use this software and its results
  71.  
  72.         * for fascism or military purposes
  73.  
  74.         * if you do not agree to the copyright note
  75.  
  76.      In this case you must delete the software and all related and
  77.      generated files immediately!
  78.  
  79. CONTENTS OF THE PACKET
  80.      The Scout packet is only entire with these files:
  81.           Scout/arexx/activatetask.scout
  82.           Scout/arexx/arexx.readme
  83.           Scout/arexx/arexx.readme.info
  84.           Scout/arexx/breaktask.scout
  85.           Scout/arexx/freezetask.scout
  86.           Scout/arexx/poptofront.scout
  87.           Scout/arexx/settaskpri.scout
  88.           Scout/arexx/startup.scout
  89.           Scout/arexx.info
  90.           Scout/help/deutsch/scout-39.guide
  91.           Scout/help/deutsch/scout-39.guide.info
  92.           Scout/help/deutsch/scout.doc
  93.           Scout/help/deutsch/scout.doc.info
  94.           Scout/help/deutsch/scout.dvi
  95.           Scout/help/deutsch/scout.guide
  96.           Scout/help/deutsch/scout.guide.info
  97.           Scout/help/deutsch.info
  98.           Scout/help/english/scout-39.guide
  99.           Scout/help/english/scout-39.guide.info
  100.           Scout/help/english/scout.doc
  101.           Scout/help/english/scout.doc.info
  102.           Scout/help/english/scout.dvi
  103.           Scout/help/english/scout.guide
  104.           Scout/help/english/scout.guide.info
  105.           Scout/help/english.info
  106.           Scout/help.info
  107.           Scout/icons/icons.readme
  108.           Scout/icons/icons.readme.info
  109.           Scout/icons/Scout.info
  110.           Scout/icons/ScoutDock
  111.           Scout/icons/ScoutDock.info
  112.           Scout/icons.info
  113.           Scout/libs/identify.library
  114.           Scout/libs/identify.readme
  115.           Scout/libs/identify.readme.info
  116.           Scout/libs.info
  117.           Scout/Product-Info
  118.           Scout/Scout
  119.           Scout/Scout.info
  120.           Scout/scout.history
  121.           Scout/Scout.history.info
  122.           Scout/Scout.readme
  123.           Scout/Scout.readme.info
  124.           Scout.info
  125.  
  126. TRADEMARKS
  127.      All copyrights and trademarks are held by their owners.
  128.  
  129. System Requirements
  130. ===================
  131.  
  132.     Scout only requires Amiga operating system version 2.04 and the
  133. identify.library V7.  See also Identify.
  134.  
  135.    If you want to use Scout's graphical user interface, you also have
  136. to install MUI version 2.1 or higher.  See also MUI.
  137.  
  138.    The TCP/IP features of Scout are only available, if you have
  139. installed the version 4.0 of AmiTCP.  See also AmiTCP.
  140.  
  141. MUI - MagicUserInterface
  142. ========================
  143.  
  144.              (C) Copyright 1992-97 by Stefan Stuntz
  145.  
  146.    MUI is a system to generate and maintain graphical user interfaces.
  147. With the aid of a preferences program, the user of an application has
  148. the ability to customize the outfit according to his personal taste.
  149.  
  150.    MUI is distributed as shareware. To obtain a complete package
  151. containing lots of examples and more information about registration
  152. please look for a file called muiXXusr.lha (XX means the latest
  153. version number) on your local bulletin boards or on public domain disks.
  154.  
  155.    If you want to register directly, feel free to send DM 30.- or US$
  156. 20.- to
  157.  
  158.                         Stefan Stuntz
  159.                    Eduard-Spranger-Straße 7
  160.                         80935 München
  161.                            GERMANY
  162.  
  163. Identify
  164. ========
  165.  
  166.              Copyright (C) 1996-97 Richard Körber
  167.  
  168.        Identify is a Shared Library that decodes expansion IDs, guru
  169. codes and library functions, and identifies your system.
  170.  
  171.        Identify is FreeWare. You can find a complete package in the
  172. AmiNet (util/libs/Identify.lha) or on the author's home page:
  173. http://www.is-koeln.de/einwohner/shred. To get in contact, write
  174. to shred@chessy.aworld.de.
  175.  
  176. AmiTCP
  177. ======
  178.  
  179.        AmiTCP is a TCP/IP protocol stack for the Amiga. The demo
  180. version 4.0 (or higher) should be available in greater public domain
  181. collections or on the AmiNet. Ask your preferred Amiga dealer.  =:^)
  182.  
  183. Installing Scout
  184. ================
  185.  
  186.    You only have to copy the program scout to your favourite
  187. directory, and identify.library to libs:. Then you can start it.
  188.  
  189. How to use Scout
  190. ****************
  191.  
  192.    This chapter describes the usage of Scout through its graphical
  193. user interface. This graphical user interface is based on the Magic
  194. User Interface (MUI) and MUI have to be installed in your system,
  195. if you want to use Scout trough windows and so on.
  196.  
  197.    If you don't like MUI, you should see Scout without MUI.
  198.  
  199.    If you start the program you will see the main window which includes
  200. many gadgets.  Each of these gadgets represents a certain kind of
  201. system structure.
  202.  
  203. You can choose between:
  204.  
  205.    Allocations, Assigns, Commodities, Devices, Expansions, Fonts,
  206. InputHandlers, Interrupts, Libraries, Locks, LowMemory, Memory, Mounted
  207. Devices, Ports, Resident Commands, Residents, Resources, ScreenMode,
  208. Semaphores, System, Tasks, Timer, Vectors and Windows.
  209.  
  210.    Click one of these gadgets and another window will be opened with a
  211. list of the structure type that is indicated on the pressed gadget.
  212.  
  213.          Example: Press the task gadget and you will get a window with
  214.      the list of tasks and processes.
  215.  
  216.    You can also select these functions by pressing the underlined key
  217. you see on each gadget or by using the right mousebutton menu.
  218.  
  219.    If you wish to handle/remove a given structure, you should know what
  220. you do.
  221.  
  222.          Warning: Wrong handling of the showed structures can crash
  223.      your system. At the worst you will lose your data.
  224.  
  225.     Please note: You should not be surprised, if you don't find a
  226. certain detail information in this manual, because it's to much work to
  227. explain each element of all the structures you could see in this
  228. program.
  229.  
  230.    Many books are written about these things and if you want to have
  231. more information about them, you should have a look in the specialized
  232. literature.
  233.  
  234. Allocations
  235. ===========
  236.  
  237.    This window informs about who allocated what hardware resource.
  238.  
  239. CIA
  240. ---
  241.  
  242.    The Amiga owns two CIA to control its hardware, the keyboard and the
  243. printer interfaces. Additionally, it contains a couple of timer.  This
  244. window shows which parts of the CIA are not yet allocated, or which
  245. program allocated the resource.
  246.  
  247. Timer A
  248. Timer B
  249.      This are two 16bit timer. They can also be coupled to a 32bit
  250.      timer.
  251.  
  252. Alarm
  253.      This resource informs if a third timer reached an alarm value.
  254.  
  255. Serial
  256.      This is a simple serial interface. Usually, the CIA-A one's is used
  257.      for communicating with the keyboard. The CIA-B serial interface
  258.      will not be allocated in most cases.
  259.  
  260. Flag
  261.      This is a special control line. It is connected from the CIA-A to
  262.      the Index line of the floppy disk drives.
  263.  
  264.    Note: newer DraCos do not contain the CIA chips. Thus, these
  265. hardware resources will be emulated or are even not offered.
  266.  
  267. Ports
  268. -----
  269.  
  270.    This are the resources for the internal parallel and serial
  271. interfaces.
  272.  
  273. Serial Port
  274.      This are the plain data transfer registers (transmitting and
  275.      receiving).
  276.  
  277. Serial Control
  278.      This are the serial control lines, as Carrier Detect.
  279.  
  280. Parallel Port
  281.      This are the data lines of the parallel port.
  282.  
  283. Parallel Control
  284.      This are the control lines of the parallel port, as Busy or Paper
  285.      Out.
  286.  
  287. Actions
  288. -------
  289.  
  290. Update
  291.      The window is updates each time you press this button.
  292.  
  293. Print
  294.      The window's contents are printed or saved to a file of your
  295.      choice.
  296.  
  297. Exit
  298.      The window will be closed.
  299.  
  300. Assigns
  301. =======
  302.  
  303.    This type of structure assigns a logical name to a directory.
  304.  
  305.    If you assign the directory dh0:data/documents the logical name
  306. texts:, you will also be able to choose a file filename in that
  307. directory with the path `texts:filename'.
  308.  
  309. Column items
  310. ------------
  311.  
  312. Address
  313.      Address of the assign structure.
  314.  
  315. Name
  316.      Logical name of a directory
  317.  
  318. Path
  319.      Here you will find the path of the directory.
  320.  
  321. Actions
  322. -------
  323.  
  324. Update
  325.      Selecting this gadget updates the list of assigns.
  326.  
  327. Print
  328.      This function allows you to send the list of Assigns to printer
  329.      or a selected file.
  330.  
  331. Remove
  332.      The selected assign will be removed with this function.
  333.  
  334. Exit
  335.      The Assigns window will be closed.
  336.  
  337. Commodities
  338. ===========
  339.  
  340. Commodities are small utilities. Most of them react on the input
  341. stream, or manipulate it.
  342.  
  343.    You can find some commodity examples in the Tools drawer of your
  344. Workbench.
  345.  
  346. Column items
  347. ------------
  348.  
  349. Address
  350.      Points to the CxObj structure of the commodity, containing all
  351.      data about it.
  352.  
  353. ln_Type
  354.      Structure type. Usually, it will be Broker.
  355.  
  356. ln_Pri
  357.      Priority of the commodity broker.
  358.  
  359. Flags
  360.      Flags describing the broker.
  361.  
  362. Port
  363.      All messages of the broker are sent to this MessagePort.
  364.  
  365. Name
  366.      Name of the commodity.
  367.  
  368. Actions
  369. -------
  370.  
  371. Appear
  372. Disappear
  373.      Let the selected commodity's GUI pop up or disappear. Some
  374.      commodities do not have a GUI.
  375.  
  376. Enable
  377. Disable
  378.      The commodity will be enabled or disabled.
  379.  
  380. Kill
  381.      Let the selected commodity remove itself in a clean way.
  382.  
  383. ListChg
  384. Unique
  385.      The commodity is notified that the list has been changed or that
  386.      another commodity with the same name was about to be added. This
  387.      is only useful for programmers to test out their commmodities.
  388.  
  389. Update
  390.      The list will be updated.
  391.  
  392. Print
  393.      This function allows you to send the list to printer or a selected
  394.      file.
  395.  
  396. Priority
  397.      This function allows you to change the priority of a commodity.
  398.  
  399. Remove
  400.      Removes the selected commodity from the system. Please try a
  401.      frienly remove before, using Kill. Maybe the commodity removes
  402.      itself voluntarily. =;^)
  403.  
  404. More
  405.      Opens a window with further information.
  406.  
  407. Exit
  408.      Closes the window.
  409.  
  410. Devices
  411. =======
  412.  
  413.    A device is -- like a library (see Libraries) -- a collection of
  414. functions/procedures, which have to do certain jobs.
  415.  
  416.    E.g. the trackdisk.device includes functions for the floppy disk
  417. handling.
  418.  
  419. Column items
  420. ------------
  421.  
  422. Address
  423.      Address of the device structure
  424.  
  425. ln_Name
  426.      Name of a device
  427.  
  428. ln_Pri
  429.      Priority of a device
  430.  
  431. OpenC
  432.      This element shows how often the device was opened.
  433.  
  434. RPC
  435.          RPC means RAM Pointer Count and shows how many jump
  436.      addresses of the device point into RAM.  In this way many programs
  437.      -- like the setpatch command from Commodore -- patch the system.
  438.  
  439.      Many viruses patch the system in this way too, but don't panic now.
  440.      If you check your system in regular intervals with a current virus
  441.      killer, it should be out of danger.
  442.  
  443.      If the whole program code of the device is located in RAM, you will
  444.      find a dash (minus sign) here, because in this case it's
  445.      unimportant how many jump addresses point into RAM.
  446.  
  447. ln_Type
  448.      Type of this structure (usually device)
  449.  
  450. Actions
  451. -------
  452.  
  453. Update
  454.      If you select this gadget, the list of devices will be updated.
  455.  
  456. Print
  457.      This function allows you to send the list of Devices to printer
  458.      or a selected file.
  459.  
  460. Remove
  461.      The selected device will be removed with this function provided
  462.      that no program uses this device anymore and the OpenC is zero.
  463.  
  464. Priority
  465.      Herewith the priority of the device can be changed.  A little
  466.      window will be opened, that asks you for a new priority.  Through
  467.      the new priority it can happen that the device gets a new place in
  468.      the device list.
  469.  
  470. More
  471.      Another window will be opened and you will see more informations
  472.      about the selected device.
  473.  
  474.      You will have the same effect, if you doubleclick an element of the
  475.      device list.
  476.  
  477. Functions
  478.      All device function offsets and addresses are shown up in a
  479.      subwindow.  If an appropriate .fd file exists and an FD:
  480.      assign points to its directory, then you will also see the
  481.      function names.
  482.  
  483. Exit
  484.      The Devices window will be closed.
  485.  
  486. Expansions
  487. ==========
  488.  
  489.    This window shows a list about all your expansion boards (graphic
  490. boards, memory expansions and so on) too.
  491.  
  492. Column items
  493. ------------
  494.  
  495. BoardAddr
  496.      Usually you will find the ROM of the card here.  If this address
  497.      points into RAM, the card is a memory expansion.
  498.  
  499. BoardSize
  500.      If the entry belongs to a memory expansion, the size of the memory
  501.      is displayed here.  Otherwise it's the ROM size of the card.
  502.  
  503. Manufacturer
  504.      ManufacturerID, assigned by Commodore
  505.  
  506. Product
  507.      Productnumber, assigned by the manufacturer of the board
  508.  
  509. Serial#
  510.      Serialnumber of the card (usually unused)
  511.  
  512. Actions
  513. -------
  514.  
  515. Print
  516.      This function allows you to send the list of Expansions to
  517.      printer or a selected file.
  518.  
  519. More
  520.      Now a window will be opened, that includes more informations about
  521.      the selected expansion board.
  522.  
  523.      Doubleclick an element of the Expansions list and you will have
  524.      the same effect.
  525.  
  526. Exit
  527.      The Expansions window will be closed.
  528.  
  529. Unknown expansion boards
  530. ------------------------
  531.  
  532.    If you select an expansion board by selecting its list item, you will
  533. get the name of the manufacturer and the card in the textfield you find
  534. below the list, provided that the installed version of
  535. identify.library knows about these data.
  536.  
  537.    If no information is available in this textfield or the given
  538. information is wrong, you should send me the following data, please.
  539.  
  540.      1. ManufacturerID (Manufacturer)
  541.      2. ProductID (Product)
  542.      3. Name of the company
  543.      4. Name of your expansion card
  544.  
  545.    If you send me these data, the next version of Identify will
  546. include your expansion boards. Please be as precise you can.
  547.  
  548.        Note: In some rare cases it is possible that the manufacturer
  549. name is correctly displayed in the text field, but the expansion name
  550. is wrong. Please check the More window's data first. They could be
  551. right. This difference has some technical reasons.
  552.  
  553. Fonts
  554. =====
  555.  
  556. This function will show you all fonts existing in your system.
  557.  
  558. Column items
  559. ------------
  560.  
  561. YSize
  562.      Vertical size of the font
  563.  
  564. Count
  565.      Here you can see how many programs use the font.
  566.  
  567. Type
  568.          ROMFONT means the font is located in ROM and DISKFONT
  569.      means the font was loaded from disk/harddisk.
  570.  
  571. Name
  572.      Name of the font
  573.  
  574. Actions
  575. -------
  576.  
  577. Update
  578.      The list of fonts will be updated.
  579.  
  580. Print
  581.      This function allows you to send the list of Fonts to printer or
  582.      a selected file.
  583.  
  584. Close
  585.      The font will be closed by using this function.
  586.  
  587. Remove
  588.      It is possible to remove a font from system, provided that no
  589.      program uses it and it's no ROMFONT.
  590.  
  591. Exit
  592.      The Fonts window disappears.
  593.  
  594. InputHandlers
  595. =============
  596.  
  597.    Input handlers take care of all user input arriving in system
  598. (pressed keys, mouseclicks, inserted disks, etc.). They stand one
  599. behind the other like on a production line and analyze the user input.
  600. The input handler with the highest priority gets the `events' first and
  601. if it doesn't know how to react on these `events', the second input
  602. handler gets them, and so on.
  603.  
  604.    Usually the system input handler has a priority of 50.  Every input
  605. handler, that wants to get the user input before the system, must have
  606. a higher priority.
  607.  
  608. Column items
  609. ------------
  610.  
  611. ln_Name
  612.      Name of the input handler
  613.  
  614. ln_Pri
  615.      Its priority
  616.  
  617. is_Data
  618.      This address points to some data needed by the input handler.
  619.  
  620. is_Code
  621.      The program code starts here.  If the code is located in RAM, the
  622.      address is of different color.  Otherwise you can find the code in
  623.      ROM.  Some viruses install an input handler in system.  In this
  624.      case the is_Code address points into RAM, but many other
  625.      programs uses input handlers, too.  Don't panic!
  626.  
  627. Actions
  628. -------
  629.  
  630. Update
  631.      The list of input handlers will be updated when you select this
  632.      gadget.
  633.  
  634. Print
  635.      This function allows you to send the list of InputHandlers to
  636.      printer or a selected file.
  637.  
  638. Remove
  639.      Removes an input handler from system.
  640.  
  641. Priority
  642.      Changes the priority of an input handler.
  643.  
  644. Exit
  645.      The window will be closed.
  646.  
  647. Interrupts
  648. ==========
  649.  
  650.    Interrupts are important events the computer system has to react on.
  651. It exists a list of interrupt routines for each interrupt type. If a
  652. certain interrupt occurs, all these interrupt routines will be called.
  653. During their execution the running program will be interrupted.
  654.  
  655. Column items
  656. ------------
  657.  
  658. ln_Name
  659.      Name of the interrupt
  660.  
  661. ln_Pri
  662.      Its priority
  663.  
  664. is_Data
  665.      At this address you find the data of the interrupt.
  666.  
  667. is_Code
  668.      Address of the interrupt code.  If this address points into RAM,
  669.      it's of a different color.
  670.  
  671. NUM
  672.      This number represents the type of event the interrupt routine is
  673.      called on.  The IntName you find in the interrupt detail window
  674.      gives you a little bit more information about it.
  675.  
  676.          Example: Number 5 means that the interrupt is called at every
  677.      vertical blank interval.
  678.  
  679. Actions
  680. -------
  681.  
  682. Update
  683.      The list of interrupts will be updated.
  684.  
  685. Print
  686.      This function allows you to send the list of Interrupts to
  687.      printer or a selected file.
  688.  
  689. Remove
  690.      If the interrupt is a server you can remove it from system.  An
  691.      interrupt handler can't be removed by Scout.
  692.  
  693.      If you call avail flush and the audio.device isn't used, the
  694.      interrupt handlers of the audio.device will be removed.
  695.  
  696. More
  697.      Now a window will be opened that includes more details of the
  698.      interrupt.
  699.  
  700. Exit
  701.      Selecting this gadget will close the Interrupts window.
  702.  
  703. Libraries
  704. =========
  705.  
  706.    A library is a collection of functions/procedures, which have to do
  707. certain jobs. E.g. the `graphics.library' includes routines for
  708. graphical display.
  709.  
  710. Column items
  711. ------------
  712.  
  713. Address
  714.      Adress of the library structure
  715.  
  716. ln_Name
  717.      Name of a library
  718.  
  719. ln_Pri
  720.      Priority of a library
  721.  
  722. OpenC
  723.      Here you see, how often the library was opened.
  724.  
  725. RPC
  726.          RPC means RAM Pointer Count and shows how many jump
  727.      addresses of the library point into RAM.  In this way many programs
  728.      -- like the setpatch command from Commodore -- patch the system.
  729.  
  730.      Many viruses patch the system in this way too, but don't panic now.
  731.      If you check your system in regular intervals with a current virus
  732.      killer, it should be out of danger.
  733.  
  734.      If the whole program code of the library is located in RAM, you
  735.      will find a dash (minus sign) here, because in this case it's
  736.      unimportant how many jump addresses point into RAM.
  737.  
  738. ln_Type
  739.      Type of this structure (usually library)
  740.  
  741. Actions
  742. -------
  743.  
  744. Priority
  745.      Herewith the priority of the library can be changed.  A little
  746.      window will be opened, that asks you for a new priority.  Through
  747.      the new priority it can happen that the library gets a new place
  748.      in the list of libraries.
  749.  
  750. Close
  751.      A library must be closed by all programs, if you want to remove it
  752.      from system. In this case the OpenC is zero.
  753.  
  754.      If you select this function, you will be asked, how often you want
  755.      to close it. You can choose between Once and All.
  756.  
  757.      Select All and the library will so often be closed till the
  758.      OpenC is zero.
  759.  
  760. Remove
  761.      The selected library will be removed with this function provided
  762.      that no program uses this library anymore and the OpenC is zero.
  763.  
  764.      Some libraries can't be removed from system without a reset.  So
  765.      you shouldn't wonder about it, if this happens.
  766.  
  767. Functions
  768.      All library function offsets and addresses are shown up in a
  769.      subwindow.  If an appropriate .fd file exists and an FD:
  770.      assign points to its directory, then you will also see the
  771.      function names.
  772.  
  773. Update
  774.      The list of libraries will be updated.
  775.  
  776. Print
  777.      This function allows you to send the list of Libraries to
  778.      printer or a selected file.
  779.  
  780. More
  781.      A window will be opened that includes more details of the library.
  782.  
  783. Exit
  784.      Selecting this gadget will close the library window.
  785.  
  786. Locks
  787. =====
  788.  
  789.    A lock structure shows you, that a program reads from or perhaps
  790. write into a file or a directory.  With this type of structure the
  791. system prevents, that a file will be deleted while another program gets
  792. some data from it.
  793.  
  794. Column items
  795. ------------
  796.  
  797. Access
  798.      Here you can see the type of access.  This could be READ,
  799.      WRITE or OWN.  OWN stands for a lock Scout created to
  800.      get the elements of this list.
  801.  
  802. Path
  803.      Path of the file or directory
  804.  
  805. Actions
  806. -------
  807.  
  808. Update
  809.      The list of Locks will be updated.
  810.  
  811. Print
  812.      This function allows you to send the list of Locks to printer or
  813.      a selected file.
  814.  
  815. Remove
  816.      A lock will be removed through dos.library's `UnLock()' function.
  817.  
  818. Pattern
  819.      If you give Scout a pattern, only the locks with a matching path
  820.      will be shown.
  821.  
  822. Exit
  823.      The Locks window will be closed.
  824.  
  825. LowMemory
  826. =========
  827.  
  828.    This list contains all low memory handler known to the system.
  829.  
  830.    These handlers are called in their sequence if a memory allocation
  831. is about to fail due to missing resources. The handlers try to free as
  832. much unused memory space as possible.
  833.  
  834.    `ramlib' is such a low memory handler removing unused libraries and
  835. devices from the system's memory. It is always present.
  836.  
  837.        Note: Low memory handlers are only available since AmigaOS 3.0.
  838. On older systems this list will always be empty.
  839.  
  840. Column items
  841. ------------
  842.  
  843. Address
  844.      Address of the low memory handler structure.
  845.  
  846. ln_Name
  847.      Name of the handler.
  848.  
  849. ln_Type
  850.      Type of the handler.
  851.  
  852. ln_Pri
  853.      Priority of the handler. All handlers are called in their priority
  854.      sequence.
  855.  
  856. is_Data
  857.      A pointer to some handler's private data.
  858.  
  859. is_Code
  860.      A pointer to the low memory handler code.
  861.  
  862. Actions
  863. -------
  864.  
  865. Update
  866.      The list will be actualized.
  867.  
  868. Print
  869.      This function allows you to send the list to printer or a selected
  870.      file.
  871.  
  872. Remove
  873.      The low memory handler will be removed from system.
  874.  
  875. Priority
  876.      Changes the priority of the selected handler.
  877.  
  878. Exit
  879.      The window will be closed.
  880.  
  881. Memory
  882. ======
  883.  
  884.    In this list you will find the segments of your memory.  At least you
  885. will find an entry for your chip memory.
  886.  
  887. Column items
  888. ------------
  889.  
  890. ln_Name
  891.      Name of the memory segment (e.g. chip memory)
  892.  
  893. ln_Pri
  894.      Priority of memory
  895.  
  896. mh_Lower
  897.      First address of memory
  898.  
  899. mh_Upper
  900.      Last address of memory
  901.  
  902. Actions
  903. -------
  904.  
  905. Print
  906.      This function allows you to send the list of the memory segments to
  907.      printer or a selected file.
  908.  
  909. Priority
  910.      This function allows you to change the priority of a memory
  911.      segment.  The memory segment with the highest priority will be
  912.      preferred from system, provided that no certain type of memory is
  913.      demanded.
  914.  
  915. More
  916.      Another window will be opened. This window includes more
  917.      information about the memory segment.
  918.  
  919. Exit
  920.      The window will be closed.
  921.  
  922. Mounted Devices
  923. ===============
  924.  
  925.    In this list you will find all your devices like disk drives, printer
  926. devices, etc.
  927.  
  928. Column items
  929. ------------
  930.  
  931. Name
  932.      Name of the device
  933.  
  934. Unit
  935.      Unit number
  936.  
  937. Heads
  938.      Number of heads
  939.  
  940. Cyl
  941.      Number of cylinders
  942.  
  943. State
  944.      The state shows you for example, if a disk is in drive.
  945.  
  946. DiskType
  947.      Type of a disk (e.g. OFS (OldFileSystem), FFS (FastFileSystem),
  948.      ...)
  949.  
  950. Handler or Device
  951.      The handler or the device you find here has to manage the stream of
  952.      data from and to the device.
  953.  
  954. Actions
  955. -------
  956.  
  957. Update
  958.      The list will be updated.
  959.  
  960. Print
  961.      This function allows you to send the list of Mounted Devs to
  962.      printer or a selected file.
  963.  
  964. Exit
  965.      The window will be closed.
  966.  
  967. Ports
  968. =====
  969.  
  970. Programs are able to communicate together through ports.
  971.  
  972. Column items
  973. ------------
  974.  
  975. Address
  976.      Here you will find the port structure.
  977.  
  978. ln_Name
  979.      Name of port
  980.  
  981. ln_Pri
  982.      Priority of port
  983.  
  984. mp_SigTask
  985.      The task is communicating through the port.
  986.  
  987. Actions
  988. -------
  989.  
  990. Update
  991.      The ports list will be updated.
  992.  
  993. Print
  994.      This function allows you to send the list of Ports to printer or
  995.      a selected file.
  996.  
  997. Remove
  998.      The port will be removed.
  999.  
  1000. Priority
  1001.      Herewith the port priority can be changed.
  1002.  
  1003. Exit
  1004.      The Ports window will be closed.
  1005.  
  1006. Resident Commands
  1007. =================
  1008.  
  1009.    This list includes all resident commands. That means all commands you
  1010. find in ROM and the commands you made `resident' through the
  1011. resident command.
  1012.  
  1013. Positions and sizes of their hunks you will find here, too.
  1014.  
  1015. Column items
  1016. ------------
  1017.  
  1018. Name
  1019.      Name of the command
  1020.  
  1021. UseCount
  1022.      Here you can see, how often a command was being executed at the
  1023.      time the list was build.
  1024.  
  1025. Lower
  1026.      First address of hunk in memory
  1027.  
  1028. Upper
  1029.      Last address of hunk in memory
  1030.  
  1031. Size
  1032.      Size of hunk (upper - lower - 8 bytes overhead)
  1033.  
  1034. Actions
  1035. -------
  1036.  
  1037. Update
  1038.      The list of Resident Commands will be updated.
  1039.  
  1040. Print
  1041.      This function allows you to send the list of Resident
  1042.      Commands to printer or a selected file.
  1043.  
  1044. Remove
  1045.      The selected command will be removed with this function provided
  1046.      that no program uses this command anymore and the UseCount is
  1047.      zero.
  1048.  
  1049. Exit
  1050.      The window disappears.
  1051.  
  1052. Residents
  1053. =========
  1054.  
  1055.    Resident modules are reset-protected segments (code and data).  In
  1056. the list of Residents you usually find libraries, devices and
  1057. resources.  A programmer has the possibility to make his own programs
  1058. reset-protected.  He has to initialize a resident structure for it and
  1059. then he can link the program through the kick-vectors (see Vectors) to
  1060. the list of the resident modules.  The residents you linked to system
  1061. are usually located in RAM and are of a different color.
  1062.  
  1063.    If you find a resident module that points into RAM and you don't know
  1064. which program has created it, you should start your favourite virus
  1065. detector and let it check your memory.  Many viruses prefer this way to
  1066. travel around.
  1067.  
  1068. Column items
  1069. ------------
  1070.  
  1071. Address
  1072.      At this address the resident module is located.
  1073.  
  1074. ln_Name
  1075.      Name of the resident module
  1076.  
  1077. rt_Pri
  1078.      Priority
  1079.  
  1080. rt_IdString
  1081.      Identity string of the resident module.
  1082.  
  1083. Actions
  1084. -------
  1085.  
  1086. Update
  1087.      The list of Residents will be updated.
  1088.  
  1089. Print
  1090.      This function allows you to send the list of Residents to
  1091.      printer or a selected file.
  1092.  
  1093. More
  1094.      Selecting this gadget opens a new window with more information
  1095.      about the selected resident module.
  1096.  
  1097. Exit
  1098.      The Residents window will be closed.
  1099.  
  1100. Resources
  1101. =========
  1102.  
  1103.    Usually a resource is -- like a library (see Libraries) -- a
  1104. collection of functions/procedures, which have to do certain jobs.
  1105.  
  1106.    E.g. the `filesystem.resource' includes functions for the filesystem
  1107. handling.
  1108.  
  1109. Column items
  1110. ------------
  1111.  
  1112. Address
  1113.      Address of the resource structure
  1114.  
  1115. ln_Name
  1116.      Name of a resource
  1117.  
  1118. ln_Pri
  1119.      Priority of a resource
  1120.  
  1121. OpenC
  1122.      This element shows how often the resource was opened.
  1123.  
  1124. RPC
  1125.          RPC means RAM Pointer Count and shows how many jump
  1126.      addresses of the resource point into RAM.  In this way many
  1127.      programs -- like the setpatch command from Commodore -- patch the
  1128.      system.
  1129.  
  1130.      Many viruses patch the system in this way too, but don't panic now.
  1131.      If you check your system in regular intervals with a current virus
  1132.      killer, it should be out of danger.
  1133.  
  1134.      If the whole program code of the resource is located in RAM, you
  1135.      will find a dash (minus sign) here, because in this case it's
  1136.      unimportant how many jump addresses point into RAM.
  1137.  
  1138. ln_Type
  1139.      Type of this structure (usually resource)
  1140.  
  1141. Actions
  1142. -------
  1143.  
  1144. Update
  1145.      The list of Resources will be updated.
  1146.  
  1147. Print
  1148.      This function allows you to send the list of Resources to
  1149.      printer or a selected file.
  1150.  
  1151. Remove
  1152.      The selected resource will be removed with this function, provided
  1153.      that no program uses it anymore and the OpenC is zero.
  1154.  
  1155. Priority
  1156.      Herewith the priority of the resource can be changed. A small
  1157.      window will be opened, that asks you for a new priority. Through
  1158.      the new priority it can happen that the resource gets a new
  1159.      position in the list of resources.
  1160.  
  1161. More
  1162.      Select this gadget and you get a new window with more information
  1163.      about the selected resource.
  1164.  
  1165. Functions
  1166.      All resource function offsets and addresses are shown up in a
  1167.      subwindow.  If an appropriate .fd file exists and an FD:
  1168.      assign points to its directory, then you will also see the
  1169.      function names. Note that some resources do not have functions.
  1170.  
  1171. Exit
  1172.      The Resources window will be closed.
  1173.  
  1174.        Please note: If you should find three dashes (minus signs) at
  1175. OpenC and/or RPC, the resource has no typical library structure.
  1176. This happens for example at the `FileSystem.resource'.
  1177.  
  1178. ScreenMode
  1179. ==========
  1180.  
  1181.    Screen modes define all monitor resolutions that the system is able
  1182. to show up.
  1183.  
  1184.    You surely have already selected a screen mode before. In this list,
  1185. you will find all available modes. Most of the programs filter out some
  1186. of them when they do not meet their purpose.
  1187.  
  1188. Column items
  1189. ------------
  1190.  
  1191. ModeID
  1192.      An identification number, unique to each mode.
  1193.  
  1194. Width
  1195.      Nominal width of the resolution in pixeln.
  1196.  
  1197. Height
  1198.      Nominal height of the resolution in pixeln.
  1199.  
  1200. Depth
  1201.      Maximum number of planes. The amount of colors which can be
  1202.      simultaneously displayed depends on this.
  1203.  
  1204. ScreenMode
  1205.      Name of the screen mode. Some modes do not have a real name, so
  1206.      Scout will generate it. Then it might differ from the name
  1207.      generated by other programs or screen mode requesters.
  1208.  
  1209. Actions
  1210. -------
  1211.  
  1212. Update
  1213.      The list will be updated.
  1214.  
  1215. Print
  1216.      This function allows you to send the list to printer or a selected
  1217.      file.
  1218.  
  1219. More
  1220.      Further information about the screen mode are displayed in a
  1221.      subwindow. This includes the overscan resolutions and the
  1222.      frequencies. Due to an inaccuracy of the operating system, the
  1223.      real frequencies might be a little bit different to those
  1224.      displayed.
  1225.  
  1226. Exit
  1227.      The window will be closed.
  1228.  
  1229. Semaphores
  1230. ==========
  1231.  
  1232.    The use of semaphores is a way of single-threading critical
  1233. sections.  For example only one program is allowed to use the printer
  1234. at one time, otherwise the texts would be mixed.
  1235.  
  1236. Column items
  1237. ------------
  1238.  
  1239. ln_Name
  1240.      Name of a semaphore
  1241.  
  1242. Nest
  1243.      This item counts how often the semaphore has been obtained by the
  1244.      owner task.
  1245.  
  1246. Queue
  1247.      This counter shows you, how many programs want to obtain the
  1248.      semaphore.
  1249.  
  1250. Owner
  1251.      Here you will find the name of the task that owns the semaphore.
  1252.  
  1253. Actions
  1254. -------
  1255.  
  1256. Update
  1257.      The list of Semaphores will be updated.
  1258.  
  1259. Print
  1260.      This function allows you to send the list of Semaphores to
  1261.      printer or a selected file.
  1262.  
  1263. Obtain
  1264.      This function is used to gain access to a semaphore.  The
  1265.      NestCnt will be increased at one by this call.
  1266.  
  1267. Release
  1268.      Herewith you can make a signal semaphore available to others.
  1269.  
  1270. Exit
  1271.      The Semaphores window will be closed.
  1272.  
  1273. System
  1274. ======
  1275.  
  1276. Actions
  1277. -------
  1278.  
  1279. Print
  1280.      This function allows you to send the list to printer or a selected
  1281.      file.
  1282.  
  1283. Exit
  1284.      The window will be closed.
  1285.  
  1286. Entry items
  1287. -----------
  1288.  
  1289.    In this window you will find some (partially technical) information
  1290. about your computer. Please excuse the ordinary look of the window, but
  1291. it is very easy to add more lines this way.
  1292.  
  1293. Tasks
  1294. =====
  1295.  
  1296.    In this window you find a list of all tasks and processes being in
  1297. system. Each program you start will be executed as a task or process.
  1298.  
  1299. Column items
  1300. ------------
  1301.  
  1302. ln_Name
  1303.      Name of the task/process
  1304.  
  1305. ln_Type
  1306.      Type of the structure (task or process)
  1307.  
  1308. ln_Pri
  1309.      Priority of the task/process
  1310.  
  1311. NUM
  1312.      If a non detaching program was started from shell, you will find
  1313.      here the number of the process. Programs you started from
  1314.      Workbench have a dash here.
  1315.  
  1316. State
  1317.      Here you see the state of the task or process. You will find
  1318.      Scout's own process on the top of the list with a run at this
  1319.      place, because this process is always running when it gets the
  1320.      task list.
  1321.  
  1322.          ready means the task wants to work, but it's interrupted by
  1323.      the execution of another task.
  1324.  
  1325.      A task that is waiting for a certain signal is in the state
  1326.      wait. In this case it doesn't need processing time.
  1327.  
  1328. SigWait
  1329.      Signalmask the task is waiting for.
  1330.  
  1331. Actions
  1332. -------
  1333.  
  1334. Print
  1335.      This function allows you to send the list of Tasks to printer or
  1336.      a selected file.
  1337.  
  1338. Freeze
  1339.      With this function you freeze the selected task. It can still be
  1340.      found in the list of tasks, but it gets no processing time from
  1341.      system.
  1342.  
  1343.               Warning: If you try to freeze tasks essential to the
  1344.           system like `input.device', you should have saved all
  1345.           important data, cause a RESET is the only way out!
  1346.  
  1347. Activate
  1348.      A frozen task can be activated here.
  1349.  
  1350. CPU
  1351.      Here you will find a text field and a cycle gadget. This text field
  1352.      displays -- dependent on the state of the cycle gadget -- the CPU
  1353.      load in percent.
  1354.  
  1355.      For the cycle gadget you can choose between three states:
  1356.     off
  1357.           In this case the CPU load won't be displayed. If you select
  1358.           another state, Scout will patch some system functions to
  1359.           calculate the CPU load of all tasks.
  1360.  
  1361.     full
  1362.           If you select this state, Scout sets the real cpu load to
  1363.           100%.  That means the total of the CPU loads of all tasks and
  1364.           processes will be 100%. Therefore nothing will be displayed
  1365.           in the text field.
  1366.  
  1367.     in %
  1368.               Scout starts a task named « Scout's cheat task » to
  1369.           calculate the real CPU load and it will be displayed in the
  1370.           text field.
  1371.  
  1372. Secs
  1373.      This string gadget allows you to set the intervall time for
  1374.      updating of the CPU load display.
  1375.  
  1376. Update
  1377.      The list will be updated.
  1378.  
  1379. Remove
  1380.      A task will be removed from the list.  You should prefer the freeze
  1381.      function, if you perhaps need this task again.
  1382.  
  1383.      See also Break!
  1384.  
  1385. Signal
  1386.      If you select a signal mask, it will be send to the task.
  1387.  
  1388. Break
  1389.      A signal mask that includes the signals CTRL-C and CTRL-D will be
  1390.      send to the task you selected.  Many tasks and processes end, if
  1391.      they receive these signals.
  1392.  
  1393. Priority
  1394.      The priority of a task can be changed with this function.
  1395.  
  1396. More
  1397.      Selecting this gadget will open another window that displays more
  1398.      informations about the task or the process.
  1399.  
  1400. Exit
  1401.      The window will be closed.
  1402.  
  1403. Timer
  1404. =====
  1405.  
  1406.    This window lists all current requests of the timer.device.
  1407.  
  1408. Column items
  1409. ------------
  1410.  
  1411. Address
  1412.      Address of the IO request structure.
  1413.  
  1414. ReplyPort
  1415.      Address of the port the request will be replied to.
  1416.  
  1417. Time
  1418.      Time that this request will stay in this list.
  1419.  
  1420. Unit
  1421.      There are two different measures: VBlank (which has less overhead)
  1422.      and MicroHz (which is more accurate).
  1423.  
  1424. Task
  1425.      Name of the requesting task.
  1426.  
  1427. Actions
  1428. -------
  1429.  
  1430. Print
  1431.      This function allows you to send the list to printer or a selected
  1432.      file.
  1433.  
  1434. Update
  1435.      The list will be updated.
  1436.  
  1437. Exit
  1438.      The window will be closed.
  1439.  
  1440. Vectors
  1441. =======
  1442.  
  1443. Actions
  1444. -------
  1445.  
  1446. Update
  1447.      The displayed vectors will be updated.
  1448.  
  1449. Print
  1450.      This function allows you to send the list of Vectors to printer
  1451.      or a selected file.
  1452.  
  1453. Exit
  1454.      The window will be closed.
  1455.  
  1456. Reset Vectors
  1457. -------------
  1458.  
  1459.    A program can make itself reset-protected by using the reset vectors.
  1460. If the vectors are unused, they have a value of zero. The programs
  1461. which use the Kick-Vectors (KickTagPtr, KickMemPtr and KickCheckSum)
  1462. can also be found in the list of resident structures.  See also
  1463. Residents.
  1464.  
  1465. Auto Vector Interrupts
  1466. ----------------------
  1467.  
  1468.    In a computer system with a MC68000 processor you will find the seven
  1469. Auto Vector Interrupts from address $64 to address $7c. Higher
  1470. processors (MC68010, etc.) have the VBR (Vector Base Register) that
  1471. allows you to move the interrupt table to FAST-MEM. The system will be
  1472. a little bit faster then. Scout uses the VBR if it exists.
  1473.  
  1474. Interrupt Vectors
  1475. -----------------
  1476.  
  1477.    Here you see 16 interrupt vectors (IntVecs). These vectors are
  1478. located in the `ExecBase' (base structure of the exec.library).
  1479.  
  1480. Windows
  1481. =======
  1482.  
  1483.    All screens with the windows opened on them are listed here. Screens
  1484. are of a different color as windows.
  1485.  
  1486. Column items
  1487. ------------
  1488.  
  1489. Pos(x,y)
  1490.      x and y position of the screen/window
  1491.  
  1492. Size(x,y)
  1493.      x and y size of the screen/window
  1494.  
  1495. Title
  1496.      Title of the screen/window
  1497.  
  1498. Actions
  1499. -------
  1500.  
  1501. Update
  1502.      The list will be updated.
  1503.  
  1504. Print
  1505.      This function allows you to send the list of Windows to printer
  1506.      or a selected file.
  1507.  
  1508. Close
  1509.      With this function it is possible to close screens and/or windows.
  1510.      If you close a screen, all windows on it will be closed too.
  1511.  
  1512. To Front
  1513.      The selected screen/window will be popped to front.
  1514.  
  1515. More
  1516.      If you select this gadget another window will be opened that
  1517.      displays more informations about the window or the screen.
  1518.  
  1519. Exit
  1520.      The window will be closed.
  1521.  
  1522. Scout and AmiTCP
  1523. ================
  1524.  
  1525.    This section will show you what you have to do for using Scout as
  1526. a TCP/IP service through AmiTCP. Nearly all functions of Scout can
  1527. also be used via AmiTCP.
  1528.  
  1529.    Now some knowledge will be assumed. If you don't know, what kind of
  1530. program AmiTCP represents, you should read AmiTCP's user's manual
  1531. before. (See also AmiTCP.)
  1532.  
  1533.    If you have installed AmiTCP, you can use Scout as client and
  1534. server. Except the installed programs of AmiTCP you don't need
  1535. another program for using Scout on networks.
  1536.  
  1537.    If you want to make your computer available for other systems on the
  1538. network, you have to do following two steps:
  1539.  
  1540.   1. Add the line scout 6543/tcp to file AmiTCP:db/services.
  1541.  
  1542.   2. Now please add the line scout stream tcp nowait root
  1543.      dh0:scout to file AmiTCP:db/inetd.conf. Make sure that the path
  1544.      at the end of this line is the right path for scout.
  1545.  
  1546.    That's it! If you start AmiTCP now, your computer is available for
  1547. other systems through using the options HOST, USER and
  1548. PASSWORD.
  1549.  
  1550.       Example: If I want perform some actions on some system
  1551.      structures of my own system for example, I have to start
  1552.      Scout through something like:
  1553.  
  1554.      1> scout HOST crash.north.de USER atte PASSWORD secret
  1555.  
  1556.    If you leave out option PASSWORD, you will be asked for the
  1557. correct password through the password: prompt. In this case nobody
  1558. can see your password, because it won't be displayed in shell.
  1559.  
  1560.    If you don't use option USER, AmiTCP takes the username that is
  1561. actually available in system.
  1562.  
  1563.    The usage of AmiTCP doesn't provide the installation of MUI. All
  1564. of Scout's shell commands (see also Commands) can be used via network
  1565. through AmiTCP.
  1566.  
  1567.       Example: If I want to get the task list of my system, I have to
  1568.      use something like:
  1569.  
  1570.      1> scout HOST crash.north.de USER atte PASSWORD secret Tasks
  1571.  
  1572.    You and all other users must always identify themselves through
  1573. their usernames (option USER) and their passwords (option
  1574. PASSWORD).  It's also possible to allow or deny certain systems
  1575. the usage of some services through the file AmiTCP:db/inet.access.
  1576. See also the user's manual of AmiTCP.
  1577.  
  1578.    If you want to get more informations about the implemented options
  1579. and commands, you should also see Options and Commands.
  1580.  
  1581. Scout without MUI
  1582. =================
  1583.  
  1584.    Nearly all through the graphical user interface available functions
  1585. of Scout are also available via shell. Therefore you don't really
  1586. need MUI for using Scout. But if you want to use Scout's
  1587. graphical user interface, you must have MUI in your system.
  1588.  
  1589. Options
  1590. *******
  1591.  
  1592.    There are some options for Scout which you can use, when you start
  1593. the program.  The following options are available from shell and as
  1594. tool types from Workbench.
  1595.  
  1596. ICONIFIED
  1597.          Usage: ICONIFIED
  1598.  
  1599.      If this option is activ, Scout starts iconified.
  1600.  
  1601. PORTNAME
  1602.          Usage: PORTNAME=portname
  1603.  
  1604.      The name of Scout's ARexx port can be changed into portname.
  1605.      Without this option the ARexx port is called `SCOUT.X'. The X
  1606.      stands for a decimal number that will be incremented, if a so
  1607.      called port already exists.
  1608.  
  1609. TOOLPRI
  1610.          Usage: TOOLPRI=value
  1611.  
  1612.      This option allows you to change the priority of Scout's process
  1613.      into value.
  1614.  
  1615. STARTUP
  1616.          Usage: STARTUP=command
  1617.  
  1618.      The variable command should be an ARexx script or a single ARexx
  1619.      command. Both (script or command) will be executed, when
  1620.      Scout will be started. In this way you can open more than
  1621.      only the main window by starting. Try for example the command
  1622.      OpenWindow Tasks and you will get two windows by starting
  1623.      (the main window and the task list window).
  1624.  
  1625.      (See also Commands.)
  1626.  
  1627. INTERVALTIME
  1628.          Usage: INTERVALTIME=seconds
  1629.  
  1630.      This options allows you to save your preferred update time for the
  1631.      list of tasks.  (See also Tasks.)
  1632.  
  1633. CPUDISPLAY
  1634.          Format: CPUDISPLAY=value
  1635.  
  1636.      Through the variable value you can select the state of the
  1637.      CPU cycle gadget you find in the Tasks window.  (See also
  1638.      Tasks.)
  1639.  
  1640.         * 1  means  CPU: full
  1641.  
  1642.         * 2  means  CPU: in %
  1643.  
  1644. HOST
  1645.          Format: HOST=hostname
  1646.  
  1647.      This options allows you to specify the system (hostname) you
  1648.      want to manipulate via network through AmiTCP.
  1649.  
  1650. USER
  1651.          Format: USER=username
  1652.  
  1653.      You have to use this option to identify yourself by using
  1654.      Scout as a TCP/IP service.
  1655.  
  1656. PASSWORD
  1657.          Format: PASSWORD=password
  1658.  
  1659.      Without a password Scout can't connect to another system via
  1660.      network. This option allows you to set the correct password.
  1661.  
  1662. COMMAND
  1663.          Format: COMMAND=commandline
  1664.  
  1665.      Nearly all of Scout's implemented functions are available from
  1666.      shell through this option. You don't need the COMMAND key to use
  1667.      this option. (See also Commands.)
  1668.  
  1669. SINGLEWINDOWS
  1670.          Format: SINGLEWINDOWS
  1671.  
  1672.      Some users don't like to handle the many windows of Scout. This
  1673.      option solves the problem of too many windows. If this option is
  1674.      selected, only one list window and only one detail window is
  1675.      opened at a time.
  1676.  
  1677. SORT#?TYPE
  1678.          Format: SORT#?TYPE=number
  1679.  
  1680.      Many of Scout's lists have a cycle gadget below themselves. With
  1681.      these gadgets you can select, how a certain list will be sorted.
  1682.  
  1683.          SORT#?TYPE stands for each of the following options:
  1684.        SORTLIBRARIESTYPE, SORTDEVICESTYPE,
  1685.        SORTRESOURCESTYPE, SORTTASKSTYPE, SORTPORTSTYPE,
  1686.        SORTCOMMANDSTYPE, SORTASSIGNSTYPE, SORTLOCKSTYPE,
  1687.        SORTCOMMODITIESTYPE and SORTSCREENMODETYPE.
  1688.  
  1689.          SORT#?TYPE should follow a decimal number, which selects the
  1690.      kind of sorting.
  1691.  
  1692.      Here are some examples for the list of tasks:
  1693.  
  1694.        SORTTASKSTYPE=1 the tasks will be sorted by their names.
  1695.        SORTTASKSTYPE=2 the tasks will be sorted by their priorities.
  1696.  
  1697. Scout's commands via ARexx and shell
  1698. ************************************
  1699.  
  1700.     Scout supports two kinds of commands:
  1701.  
  1702.   1. commands only available from shell
  1703.  
  1704.   2. commands available from ARexx and shell
  1705.  
  1706. ARexx port
  1707. ----------
  1708.  
  1709.    It's a feature of MUI to give each application its own ARexx port.
  1710. Therefore Scout also has an ARexx port that usually has the name
  1711. SCOUT.X. The X stands for a decimal number that will be
  1712. incremented, if a so called port already exists.
  1713.  
  1714.    You will find the name of Scout's ARexx port in the window you
  1715. get, if you select the Project/About menu.
  1716.  
  1717. Using tasknames:
  1718. ----------------
  1719.  
  1720.    If a task or a process was started from shell and hasn't detached
  1721. itself, you will find the name of the command being executed, where
  1722. usually the taskname is displayed.  The real name of those tasks
  1723. usually is something like Background CLI, but such a taskname isn't
  1724. useful.
  1725.  
  1726.          Example: If you start a non detaching task like
  1727.      DH0:Debug/Sushi from shell, you will see
  1728.      DH0:Debug/Sushi as taskname.
  1729.  
  1730.    Some ARexx commands need a taskname as parameter. You have to select
  1731. those from CLI started self detaching tasks by using their command
  1732. names like Scout displays them in the lists of tasks.
  1733.  
  1734. Commands only available from shell
  1735. ==================================
  1736.  
  1737. Help
  1738.          Format: Help
  1739.  
  1740.      This command is the most important one and it doesn't need
  1741.      parameters.  If you try Help, Scout prints a list of all
  1742.      available commands to shell.  =:^)
  1743.  
  1744.    Now 18 commands follow. These commands allow the user to get all
  1745. lists of system structures from shell. Therefore you only need to
  1746. install MUI for using Scout's graphical user interface.
  1747.  
  1748.    Each of the following commands has a shortened form that stands
  1749. behind the command in parentheses.
  1750.  
  1751.          Allocations (a), Assigns (g), Commands (c), Devices
  1752.      (d), Expansions (x), Fonts (f), InputHandlers (h),
  1753.      Interrupts (i), LowMemory (j), Commodities (k),
  1754.      Libraries (l), Memory (m), Mounts (n), Locks (o),
  1755.      Ports (p), Residents (r), Semaphores (s), Tasks (t),
  1756.      Resources (u), Vectors (v), Windows (w), System (y) and
  1757.      ScreenMode (z).
  1758.  
  1759.       Example: To get the list of ports, you only have to use scout
  1760.      ports or scout p from shell.
  1761.  
  1762. Commands available from ARexx and shell
  1763. =======================================
  1764.  
  1765. FindTask
  1766.          Usage: FindTask task
  1767.  
  1768.      This command allows you to check, if task task exists in system
  1769.      or not. The result is the address of the task task, if it has
  1770.      been found. task can be the name or the address of a task.
  1771.  
  1772. FreezeTask
  1773.          Usage: FreezeTask task
  1774.  
  1775.      The task taskname will be frozen. After that it will still be
  1776.      found in system's task list, but then it doesn't need processing
  1777.      time.  You can choose the name or the address of a task for
  1778.      task.
  1779.  
  1780. ActivateTask
  1781.          Usage: ActivateTask task
  1782.  
  1783.      If task task was frozen, it will be activated, otherwise an
  1784.      error occured. task is again a task's name or an address.
  1785.  
  1786. RemoveTask
  1787.          Usage: RemoveTask task
  1788.  
  1789.      This command removes the task task. It's lost forever.
  1790.  
  1791. BreakTask
  1792.          Usage: BreakTask task
  1793.  
  1794.          Scout sends the task task a certain signal mask that
  1795.      includes the signals CTRL-C and CTRL-D. Many programs support
  1796.      these signals and finish themselves, if they receive one of them.
  1797.  
  1798. SignalTask
  1799.          Usage: SignalTask task hexsignal
  1800.  
  1801.      This command allows you to send a signal hexsignal to the task
  1802.      task. The signal must specified as a hexadecimal number.
  1803.  
  1804.          Example:
  1805.           SendSignal 'scout' 0x001000
  1806.      sends task scout a CTRL-C and after that Scout ends.
  1807.  
  1808. SetTaskPri
  1809.          Usage: SetTaskPri task priority
  1810.  
  1811.      The task task gets a new priority (priority).
  1812.  
  1813. RemovePort
  1814.          Usage: RemovePort port
  1815.  
  1816.      The port port will be removed from Scout. port can be the
  1817.      name of a port or its address.
  1818.  
  1819. GetLockNumber
  1820.          Usage: GetLockNumber lockpattern
  1821.  
  1822.      This command returns the number of locks which have paths matching
  1823.      to the pattern lockpattern.
  1824.  
  1825.          Example: Use the command
  1826.           GetLockNumber 'WORK:Utilities/#?'
  1827.      and you will know, how many locks are currently used for files in
  1828.      the directory WORK:Utilities/.
  1829.  
  1830. RemoveLocks
  1831.          Usage: RemoveLocks lockpattern
  1832.  
  1833.      Use this command and all locks which have paths matching to the
  1834.      pattern lockpattern will be removed.  (See also
  1835.      GetLockNumber.)
  1836.  
  1837. RemoveLock
  1838.          Format: RemoveLock lockaddress
  1839.  
  1840.      The lock at adress lockaddress will be removed.
  1841.  
  1842. FindNode
  1843.          Usage: FindNode nodetype nodename
  1844.  
  1845.      This command allows you to find a certain node. You only have to
  1846.      know its name (nodename) and its type (nodetype).
  1847.  
  1848.          Nodetype can have following values:  LIBRARY, DEVICE,
  1849.      RESOURCE, MEMORY, SEMAPHORE, PORT or INPUTHANDLER.
  1850.  
  1851.          Example: If you want to get the address of the
  1852.      disk.resource you must use:
  1853.           FindNode RESOURCE 'disk.resource'
  1854.  
  1855. GetPriority
  1856.          Usage: GetPriority nodeaddress
  1857.  
  1858.      This command allows you to check the priority of a certain node
  1859.      structure. This includes all following structure types:  tasks,
  1860.      libraries, devices, resources, ports, residents, input handlers,
  1861.      interrupts, semaphores and the elements of the memory list.
  1862.  
  1863.      You only have to know the address (nodeaddress) of that
  1864.      structure.
  1865.  
  1866.          Example: The following ARexx commands store the priority of
  1867.      your chip memory in the variable pri:
  1868.           FindName MEMORY 'chip memory'
  1869.           addr = result
  1870.           GetPriority addr
  1871.           pri = result
  1872.  
  1873. SetPriority
  1874.          Usage: SetPriority nodetype nodename
  1875.  
  1876.      If you want to change the priority of the node nodename, you can
  1877.      use this command.  Again nodetype can have following values:
  1878.      LIBRARY, DEVICE, RESOURCE, MEMORY, SEMAPHORE, PORT or
  1879.      INPUTHANDLER.
  1880.  
  1881. CloseLibrary
  1882.          Format: CloseLibrary library
  1883.  
  1884.      The library library will be closed once. library can be the
  1885.      name of the library or its address.
  1886.  
  1887. RemoveLibrary
  1888.          Format: RemoveLibrary library
  1889.  
  1890.      The library library will be removed, if no program uses it.
  1891.  
  1892. RemoveDevice
  1893.          Format: RemoveDevice device
  1894.  
  1895.      The selected device device will be removed. For device use the
  1896.      name or the address of the device.
  1897.  
  1898. RemoveResource
  1899.          Format: RemoveResource resource
  1900.  
  1901.      The resource resource will be removed.
  1902.  
  1903. ObtainSemaphore
  1904.          Format: ObtainSemaphore semaphore
  1905.  
  1906.      This command allows you to obtain the given semaphore.
  1907.      semaphore can be the semaphore's name or address.
  1908.  
  1909. ReleaseSemaphore
  1910.          Format: ReleaseSemaphore semaphore
  1911.  
  1912.      The semaphore semaphore will be once released.
  1913.  
  1914. RemoveSemaphore
  1915.          Format: RemoveSemaphore semaphore
  1916.  
  1917.      You are able to remove the semaphore semaphore by using this
  1918.      command.
  1919.  
  1920. RemoveInputhandler
  1921.          Format: RemoveInputhandler inputhandler
  1922.  
  1923.      The input handler inputhandler selected through name or address
  1924.      will be removed.
  1925.  
  1926. FindResident
  1927.          Usage: FindResident resident
  1928.  
  1929.      This command returns the address of the resident structure
  1930.      resident.
  1931.  
  1932. FindInterrupt
  1933.          Usage: FindInterrupt interruptname
  1934.  
  1935.      The address of the interrupt interruptname will be returned.
  1936.  
  1937. RemoveInterrupt
  1938.          Format: RemoveInterrupt interruptname
  1939.  
  1940.      The interrupt you have selected through interruptname will be
  1941.      removed.
  1942.  
  1943. FlushDevs
  1944.          Usage: FlushDevs
  1945.  
  1946.      All not used devices will be removed. The used memory will be
  1947.      freed.
  1948.  
  1949. FlushFonts
  1950.          Usage: FlushFonts
  1951.  
  1952.      If a diskfont is in memory, but no program uses it, it will be
  1953.      removed.
  1954.  
  1955. FlushLibs
  1956.          Usage: FlushLibs
  1957.  
  1958.      All not used libraries will be removed. The used memory will be
  1959.      freed.
  1960.  
  1961. FlushAll
  1962.          Usage: FlushAll
  1963.  
  1964.      This function includes FlushDevs, FlushFonts and
  1965.      FlushLibs. All not used devices, libraries and fonts will be
  1966.      removed and the used memory will be freed.
  1967.  
  1968. ClearResetVectors
  1969.          Usage: ClearResetVectors
  1970.  
  1971.      The six reset vectors will be cleared, if you select this function
  1972.      (see Vectors).
  1973.  
  1974. PopToFront
  1975.          Usage: PopToFront title
  1976.  
  1977.      This command allows you to pop a screen or window to front. You
  1978.      only have to know its (title).
  1979.  
  1980. CloseWindow
  1981.          Usage: CloseWindow windowtitle
  1982.  
  1983.      This command closes the window that is specified through its title
  1984.      (windowtitle).
  1985.  
  1986. CloseScreen
  1987.          Usage: CloseScreen screentitle
  1988.  
  1989.      If you select this command, the screen (screentitle) will be
  1990.      closed with all its windows.
  1991.  
  1992. CloseFont
  1993.          Format: CloseFont address
  1994.  
  1995.      The font at address address will be closed once.
  1996.  
  1997. RemoveFont
  1998.          Format: RemoveFont address
  1999.  
  2000.      This command removes the font at address address, if it's not
  2001.      used by any program.
  2002.  
  2003. RemoveCommand
  2004.          Format: RemoveCommand address
  2005.  
  2006.          Scout makes the resident command at address address not
  2007.      resident.
  2008.  
  2009. RemoveAssign
  2010.          Format: RemoveAssign name
  2011.  
  2012.      With this command you're able to remove the assign name.
  2013.  
  2014. RemoveAssignList
  2015.          Format: RemoveAssignList name address
  2016.  
  2017.      This command removes the directory at address address from
  2018.      assign name. You will find the address of that directory in the
  2019.      list of assigns.
  2020.  
  2021. PrintList
  2022.          Format: PrintList listcharacter filename
  2023.  
  2024.      This command allows you to print a list (specified by the
  2025.      listcharacter) into the file filename.
  2026.  
  2027.          Example:
  2028.           PrintList t 'ram:tasklist'
  2029.      will print the list of tasks into the file 'ram:tasklist'.
  2030.  
  2031. OpenWindow
  2032.          Usage: OpenWindow windowid
  2033.  
  2034.      All windows you get if you select a gadget of Scout's main
  2035.      window, can be opened with this command.  The windowid is the
  2036.      same text you find on the main window gadgets.
  2037.  
  2038.          Example:
  2039.           OpenWindow 'Mounted Devs'
  2040.      will open the window with the list of mounted devices.
  2041.  
  2042. CxAppear
  2043. CxDisappear
  2044. CxEnable
  2045. CxDisable
  2046. CxKill
  2047. CxListChg
  2048. CxUnique
  2049.          Format: Cx... name
  2050.  
  2051.      Sends the command to the commodity named name.
  2052.  
  2053. RemoveCx
  2054.          Format: RemoveCx commodity
  2055.  
  2056.      Removes the appropriate commodity from the list. Please consider
  2057.      this as `emergency break'. Use it only if CxKill failed.
  2058.  
  2059. SetCxPri
  2060.          Format: SetCxPri commodity priority
  2061.  
  2062.      Sets the priority of a commodity.
  2063.  
  2064. How to get updates
  2065. ==================
  2066.  
  2067.    The newest version of Scout should always be available on AmiNet
  2068. or Public Domain collections, which are up-to-date.
  2069.  
  2070.    You can also find the latest version on my home page:
  2071.          http://www.is-koeln.de/einwohner/shred
  2072.  
  2073. Credits
  2074. =======
  2075.  
  2076.    Now we have to thank some people for supporting the development of
  2077. Scout on many different kinds:
  2078.  
  2079.    * Klaus `gizmo' Weber, he was always available to Atte and his many
  2080.      questions (not a few) during the programming of Scout.
  2081.  
  2082.    * Christian `cosinus' Stelter, he gave the permission to use his
  2083.      many manuals.
  2084.  
  2085.    * Stefan Stuntz for his great MagicUserInterface
  2086.  
  2087.    * all (hopefully still) bug reporting and feature requesting people:
  2088.      Kai `wusel' Siering, Martin Hauner, Peter Meyer, Karl `Charly'
  2089.      Skibinski, Michael `Mick' Hohmann, Thore Böckelmann, Bernardo
  2090.      Innocenti, ...
  2091.  
  2092.      and last but not least
  2093.  
  2094.    * all the others we've forgotten for reporting bugs, sending
  2095.      expansion boards data and so on.
  2096.  
  2097. How to reach the author
  2098. =======================
  2099.  
  2100.    If you have questions, suggestions, bug reports or anything else, you
  2101. can contact me at:
  2102.  
  2103.  
  2104.                          Richard Körber
  2105.                          Hornstraße 20
  2106.                     51465 Bergisch Gladbach
  2107.                           - Germany -
  2108.      
  2109.                  E-Mail: shred@chessy.aworld.de
  2110.                          richard.koerber@koeln.netsurf.de
  2111.  
  2112.    Send E-Mails whenever possible..
  2113.  
  2114.    If you want to contact Andreas Gelhausen, you can reach him at:
  2115.  
  2116.  
  2117.                        Andreas Gelhausen
  2118.                        Graf Spee Str. 23b
  2119.                        26123 Oldenburg
  2120.                           - Germany -
  2121.      
  2122.                   E-Mail: atte@crash.north.de
  2123.  
  2124.    Please do not contact him for bug reports, suggestions and similar.
  2125. But if you feel the urge to send a gift, then he is the right address!
  2126.  
  2127. That's it!  =:^)
  2128.  
  2129. Index
  2130. *****
  2131.  
  2132.  
  2133.  
  2134.  Allocations                            Allocations
  2135.  AmiTCP                                 AmiTCP
  2136.  ARexx                                  Commands
  2137.  ARexx port                             Commands
  2138.  Assigns                                Assigns
  2139.  Author Info                            Author Info
  2140.  Boards                                 Expansions
  2141.  Command                                Commands
  2142.  Command Line Options                   Options
  2143.  Commodities                            Commodities
  2144.  Contents                               Copyright
  2145.  Copying                                Copyright
  2146.  Copyright                              Copyright
  2147.  Copyright                              Copyright
  2148.  Credits                                Credits
  2149.  Device names, logical                  Assigns
  2150.  Devices                                Devices
  2151.  DISKFONT                               Fonts
  2152.  Distribution                           Copyright
  2153.  Expansions                             Expansions
  2154.  Fonts                                  Fonts
  2155.  FreeWare                               Copyright
  2156.  Handler, LowMemory                     LowMemory
  2157.  Hardware                               Expansions
  2158.  Identify                               Identify
  2159.  Input events                           InputHandlers
  2160.  InputHandlers                          InputHandlers
  2161.  Installation                           Installation
  2162.  Interrupts                             Interrupts
  2163.  Introduction                           Introduction
  2164.  Legalities                             Copyright
  2165.  Liability                              Copyright
  2166.  Libraries                              Libraries
  2167.  Limitation                             Copyright
  2168.  Locks                                  Locks
  2169.  Logical device names                   Assigns
  2170.  LowMemory                              LowMemory
  2171.  MagicUserInterface                     MUI
  2172.  Main Window                            Using Scout
  2173.  Manufacturer                           Expansions
  2174.  Memory                                 Memory
  2175.  Mounted Devices                        Mounted Devs
  2176.  MUI                                    MUI
  2177.  No Warranty                            Copyright
  2178.  Options                                Options
  2179.  Ports                                  Ports
  2180.  Processes                              Tasks
  2181.  RAM Pointer Count                      Devices
  2182.  Resident Commands                      Resident Cmds
  2183.  Residents                              Residents
  2184.  Resource allocation                    Allocations
  2185.  Resources                              Resources
  2186.  ROMFONT                                Fonts
  2187.  RPC                                    Devices
  2188.  ScreenMode                             ScreenMode
  2189.  Screens                                Windows
  2190.  Semaphores                             Semaphores
  2191.  System                                 System
  2192.  System Requirements                    System Requirements
  2193.  Tasknames                              Commands
  2194.  Tasks                                  Tasks
  2195.  TCP/IP                                 AmiTCP
  2196.  Timer                                  Timer
  2197.  Tool Types                             Options
  2198.  Trademarks                             Copyright
  2199.  Updates                                Updates
  2200.  Using Scout                            Using Scout
  2201.  VBR                                    Vectors
  2202.  Vectors                                Vectors
  2203.  Vertical blank interrupt               Interrupts
  2204.  What is Scout?                         Introduction
  2205.  Windows                                Windows
  2206.  
  2207.